Statistics and Counters Overview

 

This document organizes and provides descriptive information for the various non-MIB forms of statistics, often called counters, generated by the ASR 5000. For this document, these statistics are divided into two categories: bulk statistics and statistics output by CLI show commands.

Bulk statistics are typically collected within configured time frames and then the data is put into files or moved to remote systems where the data is processed. The bulk statistic variables are organized by shared concepts (such as service or interface) into schema; for example, the system schema includes all the statistics collected for the system. The schema chapters in this document contain the bulk statistic variables for each schema.

The output statistics usually provide a greater degree of granularity than the bulk statistics because:

•	the dynamic content is captured at the time the CLI command is entered,

•	the output statistic represents a single element, where the bulk statistic value is often a combination of values for multiple elements,

•	the statistical display can be finetuned based on the keywords included in the show command when it is entered.

The output statistics are organized by the CLI show command that generates their display; for example, show power all cards displays the current power status for each card in every slot of the chassis. Some of the show command outputs do not present statistics but display configuration information for reference purposes; for example, show gs-service full name <service_name> will display the configuration for the named Gs service.

Important: The variables listed below are common to (used by) all bulk statistic schema.

Common Bulk Statistic Variables

Variables	Description	Data Type
uptime	The total uptime (in seconds) of the system that created the file. Type: Counter	Int32
host	The system hostname that created the file Type: Information	String
ipaddr	The default management (local context) IP address in dotted decimal format. An empty string is inserted if no address is available. Type: Information	String
date	The UTC date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. Type: Information	String
date3	The UTC date that the collection file was created in YYMMDD format where YY represents the year, MM represents the month and DD represents the day. Type: Information	String
time	The UTC time that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. Type: Information	String
time2	The UTC time that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. Type: Information	String
time3	The UTC time that the collection file was created in HH:MM format where HH represents the hours, MM represents the minutes. Type: Information	String
epochtime	The number of seconds since Jan 1, 1970, 00:00:00 GMT. Type: Counter	Int32
schemas	Provides all the schemas. Type: Information	String
schema-delta	Provides schemas if they have changed since last output. Type: Information	String
localdate	The date (adjusted for the local timezone) that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. Type: Information	String
localdate3	The date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. The date displays in local time, not UTC. Type: Information	String
localtime	The time (adjusted for the local timezone) that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. Type: Information	String
localtime2	The time (adjusted for the local timezone) that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. Type: Information	String
localtime3	The time that the collection file was created in HH:MM:SS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. The time displays in local time, not UTC. Type: Information	String
localtz	The name of the local time zone. Type: Information	String
localtzoffset	The local offset from GMT in the form "-0400" Type: Information	String
swbuild	The software build number of the operating system. Type: Information	String

‌

Common Syntax Options

The following defines common syntax block options. These options appear in similar commands and are detailed here for easy reference.

Schema Format String Syntax

The schema format string is used to define the structure of generated bulk statistics data. The string may contain static text, dynamic content, and bulk statistic variables, or any combination.

Static text includes any ASCII characters which are of a fixed value. Static text may also include control characters by using escaped character sequences.

Escaped character short cuts are supported such as ‘\n’ for new line and ‘\t’ for tab.

Variables within the format string must be enclosed in double ampersands, e.g., “%var%”. The actual variables supported are command-dependent and are described with each command.

 

 

Cisco Systems Inc.

Tel: 408-526-4000

Fax: 408-527-0883